home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 22 / Amiga Format AFCD22 (Jan 1998, Issue 106).iso / -seriously_amiga- / shareware / sound / pplayer / docs / usage.doc < prev    next >
Text File  |  1997-11-05  |  5KB  |  121 lines
  1.  
  2.     How to use
  3.     """"""""""
  4.  
  5. Now this is simple...
  6.  -before you run it first time, edit first tooltypes
  7.  -select screenmode, to see everything select atleast size of 640*400
  8.   (Euro72:Productivity or NTSC:Highres-Laced are good choices)
  9.   use include program, getmodeID to get modeID-tooltype value!  <---notice!
  10.  -run PentagramPlayer
  11.  -select unpacked protacker-MOD file or pplist-file (PPlayer-modlist!, explained later)
  12.   hmm...you can maybe use packed files with somekind of crunchpatch, like found in MCP.
  13.  -Feel energy flowing through you...
  14.  -when you want to quit click on upperleft-corner of screen (where close-button is...)
  15.   actually, it won't care on which screens corner you click :(
  16.   ...or hit quit-key (default=F10) or use some exchange-like program
  17.  
  18. PentagramPlayer works in own screen, which can be easily moved back and top of
  19. other screens (by using screen-to-back gadget), screendraggin naturally works.
  20.  
  21.  
  22.  
  23. Tooltypes:
  24. """"""""""
  25.  
  26. modeID                 -    screenmode you want to use (>640*>400)
  27.                 use getmodeID to get ID-value, default is Euro72:Productivity
  28. ModDir                 -    select your mod-directory
  29. pointer                -    want to see pointer or not (on|off)
  30. modPattern             -    usually (mod.#?|#?.pplist) or plain #?
  31. cxQuitkey              -    commodity key, that quits program
  32. cxHidekey              -    move screen to back-key
  33. cxShowkey              -    move screen to front-key
  34. cxNextMod              -    skips current mod and loads next one (if used modlist)
  35. repeat                 -    none   - no need to explain
  36.                 single - repeats single file
  37.                 all    - repeats whole mod-list
  38. PositionEndDetection   -    (on|off) if you have lots of mods that have long "silence" part
  39.                 at the end of mod, set this on. When on as soon as music gets
  40.                 to last mod-position it loads next mod
  41. SetupFile              -    file where all picture-effects settings are! (explained later)
  42. Flashcolor             -    you can set next-picture flash color (when picture changes...),
  43.                 RGB(hex)-format, example: 800-dark red, fff-pure white, 44d-light blue
  44. effectchannel          -    select channel which will be used as ....effect-channel! Who would
  45.                 guess this ?-) Use values 0 to 3
  46. skip                   -    sets how many times sample will be played through effect-channel
  47.                 before image changes. Set this to 1, if you want PPlayer work
  48.                 like it did in previous versions.
  49.  
  50.  
  51. MODlists:
  52. """""""""
  53.  
  54. These are files that contains full path to your modules.
  55. For example:
  56.  
  57. data:modules/mod/techno/mod.200bpm
  58. data:modules/mod/techno/mod.x-treme
  59. data:modules/mod/jormas/mod.crc_error
  60. data:modules/mod/jungle/mod.acid_sunday_3
  61.  
  62. Simple, eh?
  63. Don't add any spaces before and after filenames. Spaces in filenames allowed.
  64.  
  65. You can keep MODlist files everywhere you want, because you can set
  66. default-tool to PentagramPlayer, so all you have to do is click MODlist-file,
  67. and there you got nice rave-party going :)
  68. Use full path on default-tooltype field, or add path-command in your 
  69. user-startup file. Like this one: "path work:music/PPlayer/ add", then all you
  70. have to do is to put default-tool of modlist to PentagramPlayer.
  71.  
  72. After all modules have been played PentagramPlayer quits OR if you have set
  73. Repeat-tooltype to "all" it begans playing from start again!
  74. Do not use packed modules.
  75.  
  76.  
  77. ModListCreator
  78. """"""""""""""
  79.  
  80. It used to create modlist from whole directories.
  81. Just run it and select your certain mod-dir, like data:modules/mod/jungle/
  82. and it creates newmods.pplist file at modlist directory.
  83. Can it be more simple ?!?
  84.  
  85.  
  86.  
  87. SetupFiles:
  88. """""""""""
  89.  
  90. Now this is what almost all of you wanted, so you get it :) (am I nice or what?)
  91.  
  92. Setup files are used for setting up YOUR picture files. All pictures must be
  93. in pix directory. See included setup-file for good example (I hope you
  94. downloaded some pictures too :)
  95.  
  96. Now, setup-file format follows:
  97.  
  98. +filename RGB RGB RGB E RGB RGB RGB
  99.  
  100. In front of every filename, must be "+"-sign.
  101. Filetype: IFF-ILBM 640*400, 4 colors. It's wise to keep color 0 black, when
  102. you design your pictures.
  103.  
  104. NOTE: effect-channel is used only for screen-switching (and flashing screen same time).
  105.  
  106. RGB's are Red, Green and Blue bits. In hex, 0...9A...F
  107. first three RGB's are colors of picture when no effects are being displayed
  108. last three RGB's are colors of picture when effects are being displayed (depends effect too)
  109. E is effect number, currently only 1 to 3:
  110.     1 - Flashes every RGB's separately (every channel has it own color)
  111.     2 - Flashes RGB's all in same time (all channels are mixed in one)
  112.     3 - all red components are being taken from channel 1, green from channel 2 and
  113.         blue from channel 3. In other words, creates very colorfull effects!
  114.  
  115. Don't worry if you didn't understand everything. Try and learn.
  116. You should look at Pentagram.setup file for examples.
  117. I'm sure that you learn....not :)
  118.  
  119.  
  120.     Keep'on raving!
  121.